package com.nidu.demo.notice.api;

import com.alibaba.cola.dto.MultiResponse;
import com.alibaba.cola.dto.PageResponse;
import com.alibaba.cola.dto.Response;
import com.alibaba.cola.dto.SingleResponse;
import com.nidu.demo.common.enums.StatusEnum;
import com.nidu.demo.notice.dto.*;

import java.util.Set;

/**
 * 通知公告服务接口
 *
 * @author auto
 */
public interface SysNoticeService {

    /**
     * 创建通知公告
     *
     * @param cmd 通知公告创建命令
     * @return 创建后的通知公告信息
     */
    SingleResponse<NoticeCO> add(NoticeAddCmd cmd);

    /**
     * 更新通知公告
     *
     * @param cmd 通知公告更新命令
     * @return 更新后的通知公告信息
     */
    SingleResponse<NoticeCO> update(NoticeUpdateCmd cmd);

    /**
     * 删除通知公告
     *
     * @param id 通知公告ID
     * @return 操作结果
     */
    Response delete(Long id);

    /**
     * 批量删除通知公告
     *
     * @param ids 通知公告ID列表
     * @return 操作结果
     */
    Response delete(Set<Long> ids);

    /**
     * 获取通知公告详情
     *
     * @param id 通知公告ID
     * @return 通知公告详情
     */
    SingleResponse<NoticeCO> getById(Long id);

    /**
     * 列表查询通知公告
     *
     * @return 通知公告列表
     */
    MultiResponse<NoticeCO> list(NoticeListQry qry);

    /**
     * 分页查询通知公告
     *
     * @param qry 分页查询条件
     * @return 分页结果
     */
    PageResponse<NoticeCO> page(NoticePageQry qry);

    /**
     * 修改用户状态
     *
     * @param status 状态修改命令
     * @return 操作结果
     */
    Response updateStatus(Long id, StatusEnum status);

}
